Lender Price API Web Service
Lender Price API Web Service / BorrowerCriteria Json Schema
In This Topic
    BorrowerCriteria Json Schema
    In This Topic
    Description
    Fields that are related to the individual or entity seeking to borrow the loan. This includes qualifying data such as veteran status, employment and income, and more.
    Overview
    BorrowerCriteria
    Fields that are related to the individual or entity seeking to borrow the loan. This includes qualifying data such as veteran status, employment and income, and more.
    affinityCodes : Array[string]

     An affinity code is an extra search criteria associated with products that can apply an additional adjustment . A common scenario use for is an employee code that will offer better pricing.

    affinityCodes is a field that accepts an array of affinity codes and returns results for which any of the affinity codes are applicable.

    Example:

    "affinityCode": "ABC"

    In this case, the 30 Year Conventional product has an adjustment when the affinity code is "ABC" that applies a -0.1 adjustment, or better pricing.


    An HLA/Loan Officer who knows the code can enter it in the search UI or API and receive a -0.1 adjustment applied to the pricing.

    affordableHousingType : Array[string]
    affordableHousingTypes : Array[string]
    alternateCreditScore : integer
    ami : number
    applicationTakenDate : string
    appraisalConditionAsIs : boolean
    appraisedValue : number

    For conventional programs, this value needs to be higher than $0. 

    For purchase, the lower between appraisedValue and purchasePrice is used (LTV logic).

    This field is required.

    assumption : boolean
    assumptionRate : number
    averageMedianCreditScore : integer
    balloon : boolean
    borrowerCompPlanAmount : number
    Specifies a numeric compensation plan (comp plan) value for the borrower.
    borrowerCompPlanPercent : number
    Specifies a compensation plan (comp plan) value for the borrower as a percentage.
    buyDown : string
    caseAssignementDate : string
    cashoutAmount : number
    cemaIndicator : boolean

    CEMA indicator. CEMA loans are an option open to New Yorkers to reduce the cost to refinance a mortgage. True if the borrower qualifies for a CEMA loan.

    Default is False.

    citizenshipType : string
    clientDti : number
    closedEnd : boolean
    closingDate : string
    cltv : number
    See cltv reference material.
    communitySecond : boolean
    compensationType : string
    This field determines the type of compensation a borrower receives.
    computeApr : boolean
    If set to True, the APR will be calculated.
    constructionDrawAmount : number
    creditQualify : boolean
    If the borrower's credit qualifies them for the loan, creditQualify is True.
    docType : string
    downPaymentAmount : number

    Sets the down payment amount.

    If not set, the value will be 0.

    downRate : number

    Sets the down rate amount.

    If left empty, the value is 0.

    drawAmount : number
    drawAmount is the draw amount if the client would like to price HELOC or Second Lien.
    dscr : number
    dti : number

    Debt-to-Income ratio. Set as a percentage.

    Example:

    "dti": 33

     

    dutyToServe : boolean
    employeeLoan : string
    Contains the employee loan, if applicable.
    escrowWaiver : boolean

    This field corresponds to impound or not impound. Set to True if the client qualifies for an escrow waiver.

    Default is False.

    existingFirstLien : boolean
    ext : boolean
    fhaCaseNumber : string
    If the borrower qualifies for an FHA loan, fhaCaseNumber is the ten digit number assigned to the loan, stored as a string value.
    fhaEndorsementDate : string
    fhaLoanTypes : Array[string]
    fico : integer
    firstLienPaymentAmount : number
    firstTimeHomeBuyer : boolean
    fundingFeeFinanced : string
    This field is required only if pricing a VA loan. It does not have a default value. If no value is passed, no pricing is returned. This design is intentional.
    guranteeFeeFinanced : string
    This field is required only if pricing a USDA Rural loan and does not have a default value. If no value is passed, no pricing is returned. This design is intentional.
    hcltvDrawAmount : number
    The hcltv draw amount.
    hcltvLineAmount : number
    The hcltv line amount.
    helocCriteria : HelocCriteria
    applyLineAmount : boolean
    highBalanceCounty : boolean

    True if the property is in a high balance county.

    inclusive : boolean

    Set to True to include only the listed mortgage option.

    Default is False.

    incomeAmiRatio : number
    interestOnly : boolean
    isFirstLienSame : string

    This field is simply a boolean that will activate a credit adjustment, which needs to be configured in the following fields:

     

    Example:

    This field is used if the client is doing a refinance and Lender Price was the original holder of the loan.


    Default is null.

    lenderFeeWaiver : boolean

    Set to True to waive the admin fee.

    Default value is False.

    lienPriorityType : string

    This field specifies the lien priority type.

    Values:

    • "FirstLien"

    Default value is “FirstLien” if no value is entered.

    lineAmount : number
    lmiData : LmiData
    borLimit : number
    chaseAA : boolean
    commTract : string
    counter : integer
    internal only
    date : string

    The current date.

    internal only

    machineIdentifier : integer
    internal only
    processIdentifier : integer
    internal only
    time : integer
    internal only
    timeSecond : integer
    internal only
    timestamp : integer
    internal only
    lmiSubsidyId : string
    lmiTract : integer
    lmiType : string
    msa : string
    loanAmount : number

    The loan amount. A dollar value.

    Default if left blank is 0.

    loanDownPayment : number

    The down payment on the loan. A dollar value.

    Default if left blank is 0.

    loanPurpose : string

    The purpose of the loan.

    Values:

    • "Purchase"
    • "Refinance"
    • "StreamLineRefinance"
    • "CashoutRefinance"

    Note:

    This field is required only if doing a single search.

    loanType : string

    Specifies the type of loan.

    Values:

    • "Fixed"
    • "Variable"

    Default value is "Fixed".

    Note:

    This field is required only if doing a single search.

     

     

    loanYear : integer

    The loan term, in years.

    Default value is 30.

    This field is required only if doing a single search.

    ltv : number
    The ltv value.
    monthlyDebt : number

    This value is required to calculate Debt-to-Income, stored in the dti field.

    monthlyIncome : number

    This value is required to calculate Debt-to-Income, stored in the dti field.

    monthlyReserve : number
    The monthly reserve.
    mortgageTypes : Array[string]

    The types of mortgages to search for. Use this value is performing a multisearch.

    Values:

    • "UsdaRural"
    • "VA"
    • "Conventional"
    • "BP" 
    • "NonPrime"
    • "HELOC"
    • "NonAgency"

    Default value: "mortgageTypes": ["Conventional"]

    nonOccCoBorrower : boolean
    nonWarrantableProject : boolean
    normalHelocBehavior : boolean
    numberOfBorrower : integer
    numberOfCoBorrower : integer
    occupancyRate : number
    otherExpenses : number
    ownProperties : integer
    Number of borrower owned properties.
    paymentInterestType : string

    Sets the payment interest type.

    Values:

    • "FullPITI"
    • "InterestOnly"
    • "InterestPlusFixedPrinciple"

     

    payoffStatusIndicatorFirstLien : boolean
    payoffStatusIndicatorSecondLien : boolean
    percentageFeeCriteria : PercentageFeeCriteria
    fundingFeeFinancedType : string
    fundingFeeWaived : boolean
    pmiType : string

    Values:

    • "None"
    • "LPMI"
      "BPMI"
    priorSalesDate : string
    propertyUse : string

    Identifies the use for the property.

    Values:

    • "PrimaryResidence"
    • "SecondaryVacation"
    • "Investment"

    Default value is "PrimaryResidence".

    propertyValuationType : string

    Determines the type of property valuation.

    Values:

    • "HVE"
    • "PIW"
    • "ACE"
    • "FMP"
    • "Full_Appraisal"
    • "Streamline"

     

    purchasePrice : number

    Specifies the purchase price of the property.

    Default is 500000.

    rehabBudget : number

    Used to set the rehabilitation budget for the property.

    Default is 0.

    renovationCost : number
    renovationLoan : boolean
    rent : number
    rentalPropertyCashFlowAmount : number
    rural : boolean
    selfEmployed : boolean
    specialMortgageOptions : Array[SpecialMortgageOption]

    Filters the result by the listed special mortgage options in the array of SpecialMortgageOption objects.

    If there are no special mortgage options, set inclusive to False. Otherwise,  set inclusive to True.

    Examples:

    1.   "specialMortgageOptions":[],

      "inclusive": false

    2. "specialMortgageOptions":[{"id":null,"name":"CDCore","description":"CDCore","enabled":true,"category":"AFR"}],

      "inclusive":true

    3. "specialMortgageOptions":[{"id":null,"name":"SSLI","description":"SSLI","enabled":true,"category":"AFR"},{"id":null,"name":"CDCore","description":"CDCore","enabled":true,"category":"AFR"}],

      "inclusive":true
    category : string
    The category of the special mortgage option.
    description : string
    Description of the mortgage option.
    dynamicProperties : object
    enabled : boolean
    Set to True if enabled.
    id : ObjectId
    The mortgage option ID, used for reference. 
    name : string
    Name of the special mortgage option.
    studentLoanIndicator : boolean
    subordinateLoanAmount : number

    Specifies the subordinate loan amount.

    Default is 0.

    subordinateSubType : string
    ufmipFinanced : string

     

    This field is mandatory only if pricing an FHA loan. There is no default value, meaning if no value is passed, no pricing is returned. This design is intentional.

    useCustomerTotalLoanAmount : boolean
    useSmoBackFilter : boolean
    vaLoanTypes : Array[string]
    vaUsageType : string

    Values:

    • "First_Use"
    • "Subsequent_Use"
    valueOfCollateral : number

    Sets the value of the collateral.

    Default is null.

    varaiableLoanTypes : Array[string]

    This field is required for Variable loan types. If the array is empty, Lender Price will search all possible types.

    Values:

    • "_1_1"
    • "_2_1"
    • "_3_1"
    • "_5_1"
    • "_5_2"
    • "_5_5"
    • "_7_1"
    • "_7_2"
    • "_10_1"

    Default is empty.

    veteranType : string

    Determines the veteran status of the borrower. Leaving null indicates the borrower is not a veteran.

    Values:

    • "Active_Or_Veteran"
    • "Reserves_Or_National_Guard"

    Default is null.

    mortgageLimit : string

    Lender Price calculates this value automatically.

    Values:

    • "Conforming"
    • "HighBalance"
    • "Jumbo"
    totalLoanAmountByMortgage : double
    The total amount by mortgage.
    Properties
    NameDescriptionData Type

     An affinity code is an extra search criteria associated with products that can apply an additional adjustment . A common scenario use for is an employee code that will offer better pricing.

    affinityCodes is a field that accepts an array of affinity codes and returns results for which any of the affinity codes are applicable.

    Example:

    "affinityCode": "ABC"

    In this case, the 30 Year Conventional product has an adjustment when the affinity code is "ABC" that applies a -0.1 adjustment, or better pricing.


    An HLA/Loan Officer who knows the code can enter it in the search UI or API and receive a -0.1 adjustment applied to the pricing.

    Array[string]
     Array[string]
     Array[string]
     integer
     number
     string
     boolean

    For conventional programs, this value needs to be higher than $0. 

    For purchase, the lower between appraisedValue and purchasePrice is used (LTV logic).

    This field is required.

    number
     boolean
     number
     integer
     boolean
    Specifies a numeric compensation plan (comp plan) value for the borrower.number
    Specifies a compensation plan (comp plan) value for the borrower as a percentage.number
     string
     string
     number

    CEMA indicator. CEMA loans are an option open to New Yorkers to reduce the cost to refinance a mortgage. True if the borrower qualifies for a CEMA loan.

    Default is False.

    boolean
     string
     number
     boolean
     string
    See cltv reference material.number
     boolean
    This field determines the type of compensation a borrower receives.string
    If set to True, the APR will be calculated.boolean
     number
    If the borrower's credit qualifies them for the loan, creditQualify is True.boolean
     string

    Sets the down payment amount.

    If not set, the value will be 0.

    number

    Sets the down rate amount.

    If left empty, the value is 0.

    number
    drawAmount is the draw amount if the client would like to price HELOC or Second Lien.number
     number

    Debt-to-Income ratio. Set as a percentage.

    Example:

    "dti": 33

     

    number
     boolean
    Contains the employee loan, if applicable.string

    This field corresponds to impound or not impound. Set to True if the client qualifies for an escrow waiver.

    Default is False.

    boolean
     boolean
     boolean
    If the borrower qualifies for an FHA loan, fhaCaseNumber is the ten digit number assigned to the loan, stored as a string value.string
     string
     Array[string]
     integer
     number
     boolean
    This field is required only if pricing a VA loan. It does not have a default value. If no value is passed, no pricing is returned. This design is intentional.string
    This field is required only if pricing a USDA Rural loan and does not have a default value. If no value is passed, no pricing is returned. This design is intentional.string
    The hcltv draw amount.number
    The hcltv line amount.number
     HelocCriteria

    True if the property is in a high balance county.

    boolean

    Set to True to include only the listed mortgage option.

    Default is False.

    boolean
     number
     boolean

    This field is simply a boolean that will activate a credit adjustment, which needs to be configured in the following fields:

     

    Example:

    This field is used if the client is doing a refinance and Lender Price was the original holder of the loan.


    Default is null.

    string

    Set to True to waive the admin fee.

    Default value is False.

    boolean

    This field specifies the lien priority type.

    Values:

    • "FirstLien"

    Default value is “FirstLien” if no value is entered.

    string
     number
     LmiData

    The loan amount. A dollar value.

    Default if left blank is 0.

    number

    The down payment on the loan. A dollar value.

    Default if left blank is 0.

    number

    The purpose of the loan.

    Values:

    • "Purchase"
    • "Refinance"
    • "StreamLineRefinance"
    • "CashoutRefinance"

    Note:

    This field is required only if doing a single search.

    string

    Specifies the type of loan.

    Values:

    • "Fixed"
    • "Variable"

    Default value is "Fixed".

    Note:

    This field is required only if doing a single search.

     

     

    string

    The loan term, in years.

    Default value is 30.

    This field is required only if doing a single search.

    integer
    The ltv value.number

    This value is required to calculate Debt-to-Income, stored in the dti field.

    number

    This value is required to calculate Debt-to-Income, stored in the dti field.

    number
    The monthly reserve.number

    The types of mortgages to search for. Use this value is performing a multisearch.

    Values:

    • "UsdaRural"
    • "VA"
    • "Conventional"
    • "BP" 
    • "NonPrime"
    • "HELOC"
    • "NonAgency"

    Default value: "mortgageTypes": ["Conventional"]

    Array[string]
     boolean
     boolean
     boolean
     integer
     integer
     number
     number
    Number of borrower owned properties.integer

    Sets the payment interest type.

    Values:

    • "FullPITI"
    • "InterestOnly"
    • "InterestPlusFixedPrinciple"

     

    string
     boolean
     boolean
     PercentageFeeCriteria

    Values:

    • "None"
    • "LPMI"
      "BPMI"
    string
     string

    Identifies the use for the property.

    Values:

    • "PrimaryResidence"
    • "SecondaryVacation"
    • "Investment"

    Default value is "PrimaryResidence".

    string

    Determines the type of property valuation.

    Values:

    • "HVE"
    • "PIW"
    • "ACE"
    • "FMP"
    • "Full_Appraisal"
    • "Streamline"

     

    string

    Specifies the purchase price of the property.

    Default is 500000.

    number

    Used to set the rehabilitation budget for the property.

    Default is 0.

    number
     number
     boolean
     number
     number
     boolean
     boolean

    Filters the result by the listed special mortgage options in the array of SpecialMortgageOption objects.

    If there are no special mortgage options, set inclusive to False. Otherwise,  set inclusive to True.

    Examples:

    1.   "specialMortgageOptions":[],

      "inclusive": false

    2. "specialMortgageOptions":[{"id":null,"name":"CDCore","description":"CDCore","enabled":true,"category":"AFR"}],

      "inclusive":true

    3. "specialMortgageOptions":[{"id":null,"name":"SSLI","description":"SSLI","enabled":true,"category":"AFR"},{"id":null,"name":"CDCore","description":"CDCore","enabled":true,"category":"AFR"}],

      "inclusive":true
    Array[SpecialMortgageOption]
     boolean

    Specifies the subordinate loan amount.

    Default is 0.

    number
     string

     

    This field is mandatory only if pricing an FHA loan. There is no default value, meaning if no value is passed, no pricing is returned. This design is intentional.

    string
     boolean
     boolean
     Array[string]

    Values:

    • "First_Use"
    • "Subsequent_Use"
    string

    Sets the value of the collateral.

    Default is null.

    number

    This field is required for Variable loan types. If the array is empty, Lender Price will search all possible types.

    Values:

    • "_1_1"
    • "_2_1"
    • "_3_1"
    • "_5_1"
    • "_5_2"
    • "_5_5"
    • "_7_1"
    • "_7_2"
    • "_10_1"

    Default is empty.

    Array[string]

    Determines the veteran status of the borrower. Leaving null indicates the borrower is not a veteran.

    Values:

    • "Active_Or_Veteran"
    • "Reserves_Or_National_Guard"

    Default is null.

    string

    Lender Price calculates this value automatically.

    Values:

    • "Conforming"
    • "HighBalance"
    • "Jumbo"
    string
    The total amount by mortgage.double
    See Also